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PREFACE 


This manual provides information on the communications program (COMHPC) which supports the 
development of HPC™ microcontroller applications on National Semiconductor’s microcontroller 
development systems. 

COMHPC is a new communications program for downloading HPC COFF absolute object modules to the 
HPC MOLE microcontroller development system. COMHPC supports Bankswitch download, as well as 
terminal emulation and command file execution. 

This manual assumes the user is already familiar with the host operating system. For example, the user 
needs to know how files are named and used under the operating system. 

Other applicable microcontroller system manuals are the Brain Board Use/s Manual, Customer Order 
Number 420408188-001, and HPC Personality Board Use/s Manual, Customer Order Number 
420410477-001. Also see HPC AssemblerILinker/Librarian Use/s Manual for information on generating 
COFF object modules, and for information on bankswitching linker. 

The information contained in this mariual is for reference only and is subject to change without notice. 

No part of this document may be reproduced in any form or by any means without the prior written con¬ 
sent of National Semiconductcff Corporation. 


HPC and MOLE are trademarks of National Semiconductor Corporation. 
UNDC is a registered trademark of AT&T. 
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Chapter 1 

INTRODUCTION 


1.1 OVERVIEW 

This manual provides information on the communications program (COMHPC) which supports the 
development of HPC microcontroller applications on the microcontroUer development system. The invo¬ 
cation and operation of COMHPC vary depending on the operating system. In the following chapters, 
invocation and operation are described for the MS-DOS operating system. For information on COMHPC 
on UNIX and VMS operating systems, refer to Appendixes B and C. 

Section 1.2 describes the communications program (COMHPC). 

Section 1.3 summarizes the notation used to describe statement syntax and user input. 


1.2 COMMUNICATIONS PROGRAM (COMHPC) 

COMHPC is a new communications program for downloading HPC COFF absolute object modules to the 
HPC MOLE development system. COMHPC supports Bankswitch download, as well as terminal emula¬ 
tion and command file execution. 


13 DOCUMENTATION CONVENTIONS 

The following documentation ccaiventions are used in text, syntax descriptions, and examples in describ¬ 
ing commands and parameters. 


1 J.l General Conventions 

Nonprinting characters are indicated by enclosing a name for the character in angle brackets <>. For 
example, < CR> indicates the RETURN key, < ctrl/B> indicates the character input by simultaneously 
pressing the control key and the B key. 


13.2 Conventions in Syntax Descriptions 

The following conventions are used in syntax descriptions. 

Italics are used for items supplied by the user. The italicized word is a generic term for the 
actual operand that the user enters. 

Spaces or blanks, when present, are significant; they must be entered as shown. Multiple 
blanks or horizontal tabs may be used in place of a single blank. 

{ } Large braces enclose two or more items of which one, and only one, must be used. 
The items are separated from each other by a logical OR sign “ |.” 

[ ] Large brackets enclose optional item(s). 
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I Logical OR sign separates items of which one, and only one, may be used. 

... Three consecutive poiods indicate optional repetition of the preceding item(s). If a 
group of items can be repeated, the group is enclosed in large parentheses “( 

Three consecutive commas indicate optional repetition of the preceding item. Items 
must be separated by commas. If a group of items can be repeated, the group is 
enclosed in large parentheses “( ).” 

( ) Large parentheses enclose items which need to be grouped together for optional 
repetition. If three ccmsecutive commas or periods follow an item, only that item 
may be repeated. The parentheses indicate that the group may be repeated. 

i_i Indicates a space, u is only used to indicate a specific number of required spaces. 

All other characters or symbols tqtpearing in the syntax must be entered as shown. Brackets, 
parentheses, or braces which must be entered, are smaller than the symbols used to describe 
the syntax. (Compare user-entered [], with [ ] which show optional items.) 


13 J Example Conventions 

In interactive examples where both user input and system responses are shown, the machine ouq)ut is in 
regular type; user-entered input is in boldface type. Ouqtut from the machine may vary (c.g., the date) and 
is indicated with italic type. 
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Chapter 2 

COMMUNICATION PROGRAM (COMHPC) 


2.1 INTRODUCTION 

COMHPC is a system program which allows the user to download HPC COFF absolute object modules to 
the HPC MOLE microcontroller development system. 

COMHPC is used by connecting a serial port on the host machine to a console port of the microcontroller 
development system. File download is initiated from the host system. The host is connected through an 
RS232 cable either directly to the miaocontroller development system or indirectly through a modem. 
Appendix A contains information on the necessary cable connections. 

This chapter presents an overview of invocation and operation of COMHPC. Also included are definitions 
of some terms used, a discussion of the two different operating modes (command mode and bypass mode), 
and a discussion of the system configuration. 


2.2 OVERVIEW OF COMHPC 

COMHPC is primarily intended to allow downloading of HPC microcontroller COFF object files from a 
host system to a HPC microcontroller development board. Additional features of COMHPC are: 

• It provides automatic setup of the HPC microcontroller development system. 

• It provides automatic download of greater than 16K code or bankswitch code to the HPC microcon¬ 
troller development system. 

• It allows the user to supply an alternate set of bankswitch commands for download. 

• It does its own error checking and transmission retries. 

• It allows the host system to act as the console for the HPC microcontroller development system. 

• It allows recording of its comnumd input and responses (or only its command input) into a history file. 
Such a history file, or a simple ASCII file, can be used as input for COMHPC; thus a session recorded 
can be re-run. 

It allows the user to specify data line and baud rate. 

23 SYSTEM DEFINITIONS 

“Console” or “CRT” refers to the system console. 

“Data” port refers to a bidirectional, asynchronous RS232 port. 

NOTE: The console and data ports are different physical devices. 

As far as using COMHPC is concerned, host systems can be of two different types: 

1. A system that has two RS232 ports; one is the system console, the other is a peripheral device. 
The system runs from an RS232 CRT terminal connected to the console port. 
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Example: VTIOO connected to VAX, with a separate data line to a microcontroller develop¬ 
ment system 

2. A system that has a peripheral RS232 port (i.e., a data port), but does not have an RS232 port 
for the console. Instead, the console is an integral part of the system, or is a video monitor and 
keyboard. 

Example: IBM PC 


2.4 COMHPC MODES 

COMHPC has two operating modes: ccHnmand mode and bypass mode. COMHPC starts out in command 
mode and is switched to bypass mode by issuing the BYPASS command. Command mode is re-entered by 
issuing the bypass escape character (<ESC>). 

When COMHPC is in command mode the user issues commands to download files, monitor the microcon¬ 
troller development system, execute ctmimand files, and enable the history mechanism. 

The bypass mode is COMHPC’s “dumb terminal’ ’ function; it allows the system running COMHPC to act 
as the console for another system. 

Specifically: 

1. When the microcontroller development system is put into bypass mode, there is a simulated 
connection between the console and data ports. Characters entered at the console are sent out 
on the data port; characters sent in to the data port are sent out to the console. 

2. COMHPC buffers both character streams — this allows for temporary differences in speed 
between the host and microcontroller development system. 

3. While in bypass mode, COMHPC looks for a special escape character entered at the console. 
This character causes COMHPC to exit the bypass mode. 


2.5 SYSTEM CONFIGURATION 

This section describes how to ho<dc up the host system to a microcontroller development system. 
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The host data port COMl on IBM-PC) is connected to the microcontroller development system con¬ 
sole port On the microcontroller development system either Jl, J2 or J3 can function as the console port 
The choice should be made on the basis of port compatibility; the cable connecting the ports must be com¬ 
patible with the way both ports are wired. Most combinations of ports can be covered by one of two basic 
cable wirings. See Appendix A for more information. 

The host system is operated as normal. To operate the microcontroller development system, invoke 
COMHPC on the host system and enter bypass mode. The host system console acts as the console for the 
microcontroller development system. A separate CRT terminal for the microcontroller development sys¬ 
tem is not needed. 


2.6 STARTUP AND DOWNLOAD DETAILS 

On startup, COMHPC establishes initial handshake with the microcontroller development system and 
invokes the MONITOR program (the microcontroller development system prompt is M>). Before initiat¬ 
ing download, COMHPC automatically invokes the COMM program on the microcontroller development 
system. During download, all data is initially loaded to SH (shared/on-board) memory and then, if 
required, moved to user (off-board) memory. (See HPC Personality Board UsePs Manual for details of 
emulation memory management.) COMHPC does multiple downloads of 16K each in case of bankswitch 
download or if code size is more than 16K. This is necessary because SH memory is limited to 16K. After 
completing download, COMHPC again invokes the microcontroller development system’s MONITOR 
program. At this point the user can enter bypass mode to run and test his downloaded program. 

The microcontroller development system SH blocks to be used for emulation after the download are 
defined by the user with the /B option on the invocation line or the BLOCK command on the command 
line. If /B or BLOCK is not specified, default SH blocks 12,13,14,15 are used. It is critical for proper 
download and emulation that the microcontroller development system SH blocks are properly specified to 
reflect the user’s system memory configuration (see BLOCK command). 

The user can also define alternate bankswitch commands for different bankswitch schemes. For this, the 
user may specify a bankswitch command file with the IS option (see Section 2.8.7). 

The actual download sequence is as follows: 

1. If there is user memory to load, the SH memory blocks are mapped to 12,13,14,15. Code (of 
maximum size 16K) is downloaded to SH. The bank (if any) is selected, and the code is 
moved to user memory. 

2. If there is more code to load to user memory, step 1 is repeated. 

3. Finally, the SH blocks are mapped as specified by the user. The final download loads SH 
memory. 


2.7 COMHPC INVOCAnON AND OPERATION 

This section discusses the invocation and operation of COMHPC. 
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2.7.1 Invocation 

The invocation line varies depending on the operating system. See Appendix B for invocation on a UNIX 
operating system and Appendix C for invocation on a VMS operating system. Fbr the MS-DOS operating 
system, the invocation line is as follows. 

COMHPC [options] [loadfile] [options] 

where: loadfile is the name of a COFF object file to be downloaded. I>efault extension is 

.cof. This is equivalent to command line LOAD loadfile. See LOAD 
command (Section 3.7) for more information. 

options is a list of options. No options need be specified, in which case the 

defaults will be used. Section 2.7.2 describes the option syntax. 


If no options nor loadfile are specified. Help information is displayed. 

Any error detected on the invocation line causes COMHPC to stop execution and display the part in error 
with an appropriate message. 

The following are sample invocation lines for MS-DOS systems: 

COMHPC /B=2,8,15 /M TEST 

COMHPC /H=THIS_SESSION\DEMO\S AMPLE 

COMHPC /E=THIS_SESSION.HIS TEST 

The first ccmimand line sets the microcontroller development system SH memory blocks 2,8, and 15 for 
download and loads the file test.cof. Monitoring of the microcontroller development system is also 
enabled. 

The next command line opens file this_session.his for recording this session. File sample.cof which 
resides in the directory demo is loaded. 

The last command loads file test.cof mA then executes history file this_session.his. 


2.7.2 Options 

An invocation line option is specified in a manner consistent with the operating system. See Appendix B 
for information for a UNIX system and Appendix C for a VMS system. 

The invocation line options for an MS-DOS operating system start with a “/”, which may be preceded by 
blank space. Options are not case-sensitive. Options and their arguments are separated by “=”, which 
may be preceded or followed by blank space. Option arguments are separated by which may be pre¬ 
ceded or followed by blank space. Numeric option arguments may be in hex (start with Ox), octal (start 
with 0), or decimal (not start with 0). 

See Section 2.8 for a description of all the options. 
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2.7 J Default File Extensions 


Default file extensions depend on the operating system. See Appendixes B and C for information on unk 
and VMS operating systems. Fbr MS-DOS, a default extension is always placed on a file unless one is 
explicitly specified. 

2.7.4 Help File Search Order 

When searching for help file COMHPCHLP, directories are searched in the following order: 

1. current directory 

2. default directories 

a. directory specified by environment variable COMHPC, if it exists 

b. directory specified by environment variable HPC, if it exists 

c. directory \HPC 

2.8 INVOCATION OPTIONS 

This section describes the options that may be used on the invocation line. 
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Block List 


2^.1 Block List 


Syntax: lB=block list \ OFF 

Description: The /B option sets the microcontroller development system SH memory blocks to use for 
emulation after the download. The argument block list is up to four blocks (0 to 15) or OFF. 

This option is equivalent to command BLOCK block list \ OFF in command mode. See 
BLOCK command (Section 3.2) for more information on the microcontroller development 
system SH blocks. 

NOTE: It is critical for proper download and emulation that the SH blocks 
are properly specified to reflect the user’s system memory 
configuration. Default SH blocks are 12,13,14,15. 


Example: /B=2,8,15 

This sets SH blocks 2,8 and 15. 
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Execute File 


2^.2 Execute File 

Syntax: fE=file 

Description: The /E option executes input file. All COMHPC commands including bypass commands 
contained in the input file are executed, after the load file, if any, is loaded. The input file is 
typically a history file, but may also be a simple ASCII file. The default extension of the 
input file is Ms. This option is equivalent to the command @ file in command mode. 

Example: /E=setup.his 
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History File 


1A3 History File 

Syntax: lli=file 

Description: The /H option generates a history file. The default extension is .his. All ctmiinands entered 
as well as output from COMHPC will be written to the history file. This option is 
equivalent to the command HISTORY ON, OUT, ¥=file in command mode. 

Example: /H=this_session 
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Line 


2J&A Line 

Syntax: 

Description: 

Example: 


lL,=line 


The /L option defines line and baud rate to use for download. The argument line can be 
COMl, COM2, COM3, or COM4 for MS-DOS system; default is COMl. The argument 
baud can be 300, 600, 1200, 2400, 4800, 9600, or 19200; default is 19200. No parity, 8 
data bits, 1 stop bit are set 

/l^COM2,4800 

This sets COM2 port for ccanmunication with the microcontroller development system at 
4800 baud. 
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Monitor 


2^^ Monitor 

Syntax: /M 

Description: The /M option monitors the microcontroller development system. COMHPC generates 
microcontroller development system commands which are hidden to the user. This option 
echoes all microcontroller development system commands and responses to the console, 
preceded by This option is useful in debugging COMHPC interaction with the micro¬ 
controller development system. This option is equivalent to the command MONITOR ON 
in command mode. 
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Restart 


2^.6 Restart 

Syntax: 

Description: 


/R 

The /R option restarts COMHPC without loading the COFF file, if specified The micro¬ 
controller development system is initialized to the MONITOR program (microcontroller 
development system prompt M>). Default parameters are used for download unless they 
are specified on the invocation line along with /R option. This option is equivalent to the 
command LOAD =R in cwnmand mode. 
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Bankswitch Command File 


2^.7 Bankswitch Command File 


Syntax: IS=file 

Description: The /S option defines alternate bank switch command file for microcontroller development 
system. This command file contains commands that are used by COMHPC to select the 
bank while downloading bankswitch code. Each line in file is a MONITOR command; the 
only permitted commands are ALTER, AW, or MODIFY (see HPC Personaltiy Board 
User's Manual for command usage). COMHPC will reset the upper bit of each character, 
and convert it to upper case for use by the microcontroller development system. “%” in 
file is replaced by active bank address during download (the bank address is passed from 
the COFF file). The default set of bankswitch commands is: 

MODIFY DIRB,6300 ;define bit 8,9,13,14 of Port B as output 
MODIFY BFUN,0 ;disable Port B alternate function 
MODIFY M E3,% ;bank address to upper byte of Port B 

The default file extension is .bsw. 

NOTE: Before the above bankswitch commands are executed, the MONI¬ 
TOR commands RESET and SINGLESTEP are executed to break¬ 
point the HPC chip. 

Example: /S=bankfile.bsw 
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Chapter 3 

COMHPC COMMANDS 


3.1 INTRODUCTION 

After the COMHPC program is invoked, the prompt 
coinhpc> 

indicates the program is ready to accept a command and is in command mode. 

The command formats are listed alphabetically in Table 3-1. The definitions used in the command formats 
are listed in Table 3-2. 

The minimum abbreviation for a command name is indicated by the uppercase letters of the command 
name in the syntax description. For example, BYPASS may be specified as BY, BYP, BYPA, BYPAS, or 
BYPASS. Commands are not case sensitive. 

The commands may be optionally preceded by blank space. The commands and their arguments are 
separated by blank space. The command arguments are separated by which may be preceded or fol¬ 
lowed by blank space. The default file extensions are dependent on the operating system (see Section 
2.7.3). 
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Table 3-1. COMHPC Commands 


COMMAND 

OPERANDS 

DESCRIPTION 

BLock 

[block list 1 OFF] 

Specify/Display microcontroller 
development system SH Blocks. 

BYpass 


Enter bypass mode. 

End 


Exit COMHPC and return to host 

Help 

[commandl 

List the syntax of all ctxnmands or 
a specific command to the console. 

History 

[(ONIOFF),] [(OUTINO),] [F=^/e] 

Specify/Display history parame¬ 
ters. 

LOad 

[^/el=R] 

Download file or restart microcon¬ 
troller development system. 

MONitor 

[ON 1 OFF] 

Specify/Display microcontroller 
development system monitoring 
status. 

@ 

We] 

Execute commands from input file. 

» 

text 

Comment line. 

! 

system command 

Invoke operating system command. 
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Table 3-2. Command Fbrmat Definitions 


OPERANDS 

DESCRIPTION 

ON 

Enable 

OFF 

Disable 

OUT 

Output Enable 

NO 

Output Disable 

=R 

Restart microcontroller develop¬ 
ment system only 

block list 

List of up to 4 microcontroller 
development system SH blocks, 0 
to 15 

file 

Valid filename 

system command 

Operating system command 

text 

Character string terminated by a 
carriage return 
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3.2 BLOCK COMMAND 


Syntax: 


BLock [Wocit list | OFF ] 



Description: The BLOCK ccnnmand spepmes/displays the microcontroller development system SH 
Blocks to use for emulation. The argument block list is up to four blocks or OFF. If no 
argument is specified, this command displays SH Blocks that were set with previous /B 
option or BLOCK command. 


The microcontroller development system SH memory provides emulation memory on the 
microcontroller development system. The user may optionally provide his own user 
memory in addition to SH memory, or in place of SH memory. SH is mapped in 4K blocks; 
therefore, as SH is limited to 16K size, the user can specify a maximum of four blocks. 
Each block starts on a 4K page boundary and has a block number that equals the most 
significant nibble of the address space; for example, 5000/5FFF has the block number 5. 
See the HPC Personality Board User’s Manual for more information on SH Blocks and 
usage. 


If the user has bankswitched memory, SH blocks cannot fall into the switchable bank 
address range. This is because SH blocks are always visible to the system and cannot be 
bankswitched. 


NOTE: It is critical for proper download and emulation that the microcon¬ 

troller development system SH Blocks are properly defined to reflect 
the user’s system memory configuration. The default SH blocks are 
12,13,14,15. 


Example: coinhpc> BLOCK 

MOLE SH Blocks = 2,8,15 

In this example, SH Blocks 2,8,15 are set, then displayed. 

comhpc> BLOCK 

MOLE SH Blocks = 2,8,15 

In this example, the current SH Blocks are displayed. 
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BYPASS COMMAND 


3J BYPASS COMMAND 


Syntax: BYpass 

Description: The BYPASS command puts the host machine into bypass mode, wh^e the host acts as a 
dumb terminal for the microcontroller development system. 

When the host is put into bypass mode, there is a simulated connection between the console 
and the data port Characters ottered at the console are sent out on the data port; characters 
sent in to the data port are sent out to the console. Temporary dififerences in speed between 
the host and the microcontrollo development system are taken care of by COMHPC 
buffering. 

The bypass mode allows the user to interact directly with the microcontrollo development 
system in a transparent manner. Note that this obviates the need of a separate CRT termi¬ 
nal for the microcontroller development system. All work is done from the host system 
console. 

The bypass mode is exited when <ESC> is entered at the console. 

Example: Assume the microcontroller development system is in MONITOR program (microcon¬ 

troller development system M> prompt). 

comhpc>BYPASS 

M> LIST 


M> <ESC> 
comhpc> 

In this example, entoing BYPASS puts the host into bypass mode. The user then issues 
some microcontroller development system MONITOR commands and when <ESC> is 
pressed, the host exits the bypass mode, returning to COMHPC prompt Oeaving the micro¬ 
controller development system in MONITOR program). 
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END COMMAND 


3.4 END COMMAND 

Syntax: End 

Description: The END command exits COMHPC and returns to the host operating system. 
Example: coinhpc> END 
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HELP COMMAND 


3^ HELP COMMAND 


Syntax: Help [command] 

Description: The HELP command, with no argument, lists the syntax of all commands to the console. If 
a command argument is given, specific information is given on that command. 


Example: comhpc> HELP 

BLock [<block list> | OFF] 


BYpass 

End 

Help 

History 


MONitor 


[<block list> I OFF] specify/display MOLE SH blocks 

enter bypass mode 
exit COMHPC 

[<command>] gives command help 

[(ON I OFF),] [(OUT I NO),] [f=<file>] 

specify/display history parameters 
[<file> I =R] load file or restart MOLE 

[ON I OFF] specify/display monitor status 

[<file>] execute commands from file 

<comment> ignore this line 

<system command> invoke operating system command 


comhpc> HELPJ^ 

command> 




an operating system command. 
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HISTORY COMMAND 


3.6 HISTORY COMMAND 


Syntax: History [(ONIOFF),] [(OUTINO),] [F=file] 

Description: The HISTORY command specifies and controls the history file generation. When ON, all 
commands entered will be written to the history file. If OUT is specified, the command out¬ 
put will also be written to the history file, preceded by the comment character. 

The history command, without any arguments, will display current history status. 

Once a history file has been selected, either on the invocation line or with this command, 
the recording may be turned ON and OFF without renaming the file. 

The History ON and OFF commands will be written to the History file with the comment 
character prepended. 

The default extension of the history file is Ms. 

This command is useful for saving a COMHPC session on a file. It is also useful for debug¬ 
ging purposes. Such a history file can be used as input for the COMHPC; thus, a session 
recorded can be re-run. 

Example: comhpc> HISTORY ON,NO,F=this_session 

History ON,NO,F=this_session.his 

This and the following commands entered will be written to the file this_session.his. The 
specified history parameters are displayed. 

comhpc> HISTORY OUT 

History ON,OUT, F=this_session.his 

This and the following commands as well as the command output will be written to the his¬ 
tory file. The modified history parameters are displayed. 

comhpc> HISTORY 

History ON,OUT,F=this_session.his 

The command HISTORY, when invoked without any arguments, displays the current his¬ 
tory parameters. 
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LOAD COMMAND 


3.7 LOAD COMMAND 
Syntax: LOad [file I =R ] 

Description: The LOAD command loads the specified COFF object file into the microcontroller 
development system. The default extension of the file is .cof. After the load, the SH blocks 
are mapped as specified by the /B option or BLOCK command; default SH blocks are 
12,13,14,15. 

If no argument is specified, the load uses the file specified on the last LOAD command or 
on the invocation line (it is an error if no load file was previously specified). If the argu¬ 
ment is “=R”, no load is done; the microcontrollCT development system is initialized to the 
MONITOR program (microcontroller development system prompt M>). 

When the LOAD command is invoked, first the SH blocks specified are displayed. Next, 
during the download, COMHPC continuously displays retry count and the number of 
transmission data blocks sent to the microcontroller development system. Upon successful 
completion of the download, message transmission complete is also displayed. 

COMHPC determines alternate bank switch commands and line parameters from the /S and 
the /L options on the invocation line. When these options are not specified, their default 
values are used. 

The error messages and their likely causes are discussed in Section 4. 

NOTE: It is critical for proper download and emulation that the SH blocks be 
defined properly to reflect the user’s system memory configuration. 

See BLOCK command. 

Example: comhpc> LOAD TEST.COF 

MOLE SH block = 12,13,14,15 

block sent: #### 
retry: #### 

TRANSMISSION COMPLETE 

This command initiates download of the object file test.cof. The microcontroller develop¬ 
ment system SH blocks are indicated. During the download, the number of blocks sent and 
retry count are continously upxlated. The message TRANSMISSION COMPLETE indi¬ 
cates that the download was successful. 
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MONITOR COMMAND 


3^ MONITOR COMMAND 


Syntax: MONitor [ON I OFF ] 

Description: The MONITOR command specifies/displays the microcontroller development system 
monitoring status. 

COMHPC generates microcontroller development system commands which are hidden to 
the user. If the argument is “ON”, all microcontroller development system commands and 
responses are echoed to ccmsole, preceded by This command is useful in debugging 
COMHPC interaction with the microcontroller development system, particularly when 
mors occur in the system. 

If no argument is specified, the current status is shown. 


Example: conihpc> MONITOR ON 

Monitor on 

This example sets the microcontroller development system monitoring. 
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@ (EXECUTE) COMMAND 


3.9 @ (EXECUTE) COMMAND 
Syntax: @ [file ] 

Description: The @ command executes the COMHPC commands from the input file. Files may nest to 
the limit of memory. Commands being executed are also echoed on the console. On error, 
execution of the input file is aborted and control transferred to console. Execution of the 
input file can be resumed with entering @ without a filename. 

A simple ASCII or a history file (for example, as generated earlier by the HISTORY com¬ 
mand) can be used as an input file. Thus, this command in conjunction with the HISTORY 
command, can be used to re-run frequently executed commands, or commands saved ear¬ 
lier, in “batch” mode. 

The default extension of file is .his. 

Example: coxnhpc> @COM.HIS 


LOAD test.cof 

error: file not found 
input file aborted. 

comhpc> LOAD tst.cof 


coinhpc> @ 


coinhpc> END 

In this example, COMHPC starts executing commands from the input file com. his in 
response to @com.his entered by the user. When an error occurs while executing the com¬ 
mand load testcof, the file com.his is aborted and control returns to the COMHPC prompt 
The user then loads the proper file and resumes execution of com.his by entering 
Finally, COMHPC exits when the user enters the command END. 
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; (COMMENT) COMMAND 




3.10 ; (COMMENT) COMMAND 


Syntax: ;comment 

Description; The ; command COMHPC to ignore all characters including and after till the 

end of line. This allows commenting history files and also c^turing the output of a session 
without interfering with reuse of the session as an input file. Comment lines will be echoed 
to the history file if appropriate, but with an additional comment character prepended. 


Example: coinhpc> HISTORY ON,OUT4^=this_session.his 

coinhpc> ;Now execute input file 
comhpc> @last_sessionJiis 

In this example, the user first enables history recording and then issues the command to 
execute commands from the file last session.his. The comment line in this case enhances 
the readability of the history file. 
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! (SYSTEM) COMMAND 


3.11 ! (SYSTEM) COMMAND 


Syntax: 

Description; 

Example: 


'.operating system command 

The! command invokes a shell or executes an operating system command. 
Irename a.his b.lus 

In this example, the file a.his is renamed to b.his. 
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Chapter 4 

COMHPC ERROR MESSAGES 


4.1 INTRODUCTION 

Several categories of errors are possible: the option or command specification could be incorrect; the 
download may have errors; the loading may be aborted by the user, or the microcontroller development 
system encountered errors. The error messages and their likely causes are discussed in this chapter. 


4.1.1 Option and Command Error Messages 

Option and command error messages are listed in Table 4-1. 
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Table 4-l,(Operand Error Messages 




:> 


MESSAGE 

DESCRIPTION 

Bad argiunent 

Argument specified is not valid. 

Bad bankswitch command file 

Bankswitch command file must contain alter, aw, or modify com> 
mands only. 

Bad object file 

File specified for download is not a valid COFF object file. 

Bad octajfl constant 

Invalid octa^l characters. 

Bad option 


Block not available 

The microcontroller development system SH Block specified is not 
available for download and emulation. 

Cannot open file 

Error in opening file 

Closing history file 

Output history file closed. 

Disk directory full 

Disk directory full. 

Disk error 

Error in opening, closing or renaming file. 

Excess argument 

Excess argument on line. 

File not found 

File specified not found in the directory. 

Help file not found 

Help file not found. 

Input file aborted 

Input history file aborted. 

Initial handshake aborted 

Initial handshake aborted. 

Invalid filename 

Illegal filename. 

Line error 

Error opening line. 

Missing argument 

No argument specified for the option. 

Missing file name 

Filename required. 

MOLE not respond 

No response from microcontroller development system; check line 
or microcontroller development system. 

No file specified 

No file specified where a filename was required. 

Not an object file 

File specified for download is not a valid COFF object file. 

Object file contain no data 

No data to download. 

Out of memory 

Not enough memory is available to execute the command. 

Read error 

Error while reading file. 

Syntax enor 

Badly formed command line. 

Too many files 

Too many files open. 

Unknown command 

Unknown command. 

Unknown option 

Illegal option. 

Unsupported baud rate 

Baud rate specified is not supported. 

Unsupported data line 

Data line specified is not supported. 

Write error 

Error while writing to file. 
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When an error occurs in the invocation or command line, the error message is displayed with an arrow 
pointing to the position where the error occurred. For example: 

1. coinhpc> @comnd.his ; error on command line 


error; file not found 



COMHPC /R /L=COM1,110 testcof ; error on invocation 
error: unsupported baud rate 


4.1.2 Abort Error Messages 

Table 4-2 lists the transmission abort error messages. 


To understand the abort messages better, it is important to know that there are two phases to the transmis¬ 
sion. The probable cause of an error message depends upon whether the error occurs during phase 1 or 
phase 2. 


Phase 1 is an initialization transmission; this part of the transmission occurs after the load command is 
invoked, but before any data blocks are sent Aborts, during this phase, are generally due to a bad com¬ 
munications line or to incompatible UART settings. 


During phase 2 of the transmission, the actual file download occurs. During this part of the transmission, 
aborts are mostly due to a line with marginal quality or actual loss of the line. 


4.13 User Abort 

The user who invoked the transfer may abort it anytime by hitting <CTRL/C>. An abort message is sent 
to the microcontroller development system so that the microcontroller development system will abort 
cleanly. 


4.1.4 Error Messages 

Whenever the microcontroller development system responds unexpectedly, the microcontroller develop¬ 
ment system responses are shown preceded by **’. This includes responses during download; for example, 
read/write verify errors while moving code from SH memory to user memory will be shown. As appropri¬ 
ate, the microcontroller development system command which caused the error will be shown in 
parentheses following the error message. To further determine the cause of a microcontroller development 
system error, the user may rerun the COMHPC command sequence with microcontroller development 
system monitoring enabled (see MONITOR command). 
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Table 4-2. Transmission Abort Error Messages 


MESSAGE 

DESCRIPTION AND CAUSES 

Bad link up 

Error in invoking download. Try 
again or check line. 

Bad map list 

Error in MAP command on 
development system. 

Bad transmission 

Bad transmission. Line may be lost 
or bad, or the microcontroller 
development system aborted. 

Code in on-chip RAM area 

Code in any bank cannot fall in 
on-chip RAM area. 

Bank address cannot fall in SH 
block 

The microcontroller development 
system SH blocks are always visi¬ 
ble for emulation and cannot be 
bank switched. 

Ulegal transmission 

Illegal transmission detected. 
Transmission cannot ccmtinue. 

MOLE aborted 

The microcontroller development 
system requested an abort after 
having a fatal mot. 

Retry oror 

Illegal transmission retry. 

Transmission timeout 

Timeout in waiting for reply. Line 
may be lost or bad, or the micro¬ 
controller development system 
aborted. 

User abort 

User aborted transmission. 
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Appendix A 

RS232 INTERFACING 


A.1 RS232 CABLES 

This appendix describes the RS232 cable required to connect the host to the microcontroller development 
system. The type of cable needed depends on the two RS232 ports being hooked together. 

RS232 ports can be of two types — Data Terminal Equipment (DTE) or Data Communication Equipment 
(DCE). Table A-1 shows the relevant RS232 signals. (“To DCE” means that the signal is an input to a 
DCE-type port and, therefore, an ouq)ut of a DTE port.) 

Table A-1. RS232 Signals (25-Pin Connector) 


PIN NUMBER 

SIGNAL NAME 

DIRECTION 

2 

Thinsmitted Data 

To DCE 

3 

Received Data 

From DCE 

7 

Signal Ground 

- 


Note that the RS232 standard assumes: a DTE sending data to a DCE through pin 2 and receiving data 
from the DCE through pin 3 of the standard connector and, correspondingly, a DCE receiving data on pin 
2 and sending data on pin 3. The cable used to connect a DTE to a DCE is a standard RS232 cable, 
referred to here as a straight through cable. DTEs can be connected to DTEs and DCEs can be connected 
to DCEs, but a straight through cable cannot be used to make the connection; a special null modem cable 
which transposes signals is required. 

A straight through cable is shown in Figure A-1. This cable will connect a host DTE port to J1 port of the 
microcontroller development system, or a host DCE port to J2 port of the microcontroller development 
system. 



Figure A-1. Straight Through Cable 


Figure A-2 shows a null modem cable. This cable will connect a host DTE port to J2 port of the microcon¬ 
troller development system, or a host DCE port to J1 port of the microcontroller development system. 

Refer to the manufacturers’s schematics to determine how a particular host RS232 port has been wired. 
Table A-2 shows which of the microcontroller development system ports are DCE or DTE. 
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PIN 

2 

3 

7 


X 


PIN 

2 

3 

7 


Figure A-2. Null Modem RS232 Cable 


Table A-2. RS232 Ports On The Microcontroller Development System 


RS232 CONNECTOR 

IS WIRED AS 

PortJl 

DCE 

PDrtJ2 

DTE 

PDrtJ3 

DCE* 

* This port can be reconfigured using 
jumpers. Refer to the Brain Board 
User's Manual, The wiring as shipped 
is indicated. 
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Appendix B 

UNIX INVOCATION AND OPERATIONS 


B.l INTRODUCTION 

This 2 ^pendix describes the invocation and operations for COMHPC on a UNIX® operating system. See 
the release letter for installation instructions. 


B.2 COMHPC INVOCATION AND OPERATION 

This section describes the operation of COMHPC on the UNIX operating system. 


Invocation 

The COMHPC invocation for a UNIX operating system is as follows: 
comhpc [options ] [loadfile ] 

where: loadfile is the name of a file to load. There is no default file extension assumed. 

options is a list of options. “-1” option must be specified; line and baud are as 

appropriate to the system. No other options need to be specified, in which 
case the defaults are used. Section B.2.2 describes the option syntax. 


If no options or loadfile specified, help is given. 

Any error detected on the invocation line causes COMHPC to stop execution and display the part in error 
with an appropriate message. 

The following are sample invocation lines for UNIX systems: 
comhpc -b 2345 -m testcof 
comhpc -h this_session.his /demo/sampkxof 
comhpc -e this_session.his testcof 

The first command line sets the microcontroller development system SH memory blocks 2,8, and 15 for 
download and loads the file test.cof. Monitoring of the microcontroller development system is also 
enabled. 

The next command line opens file this_session.his for recording this session. File sample.cof which 
resides in the directory demo is loaded. 

The last command loads file test.cof 3nd then executes the history file this^session.his. 
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B^.2 Options 

An invocation line option is specified in a mann^ consistent with the UNIX operating system. Refer to 
Section 2.8 for a detailed description of the options. 

Options for a ui^ operating system follow the System V Interface Definition. Each option is preceded by 
a Options are case sensitive. There are no optional arguments; the option either requires an argu¬ 
ment, or it doesn’t Multiple options without argument may be £q>pended together or listed separately. For 
example: 

•mr is equivalent to -m -r 

See Section B.2.4 for mapping between unk and MS-DOS invocation line options. 

B.2J Default FUe Extensions 

For UNIX operating systems, there is no default file extension assumed. 

B J.4 Help File Search Order 

When searching for help file comhpc.hlp, directories are searched in the following order: 

1. current directory 

2. default directories 

a. directory specified by environment variable COMHPC, if it exists 

b. directory specified by environment variable HPC, if it exists 

c. directory Ihpc 

B.25 Option Table 

Table B-1 shows the mapping between UNIX and MS-DOS invocation. UNIX options as well as the argu¬ 
ments are case sensitive. 


B-2 

DRAFT 


April 24,1989 



Table B-1. Mapping Between MS-DOS and UNIX Invocation 


MS_DOS 

-1 

UNIX 

/B=block list 

-b block list 

/B=OFF 

-b OFF 1 off 

/E=input file 

-e input file 

/H=history file 

-h history file 

/L=line 

-lline 

/L=line,baud 

-1 line,baud 

/M 

-m 

/R 

-r 

/S=file 

•sfile 


B-3 

DRAFT 


April 24,1989 






















Appendix C 

VMS INVOCATION AND OPERATIONS 


C.1 INTRODUCTION 

This s^pendix describes the invocation and operations for COMHPC on a VMS operating system. See the 
release letter for installation instructions. 


C2 COMHPC INVOCATION AND OPERATION 

This section describes the operation of COMHPC on a VMS operating system. 


C.2.1 Invocation 

COMHPC invocation for a VMS operating system is as follows: 

COMHPC [options] [loadfile] [options] 

where: loadfile is the name of a file to load. Default extension is .cof. 

options is a list of options. “/L” option must be specified; line and baud are as 

appropriate to the system. No other options need to be specified, in which 
case the defaults are used. Section C.2.2 describes the option syntax. 


If no options or loadfile are specified, help is given. 

Any error detected on the invocation line causes COMHPC to stop execution and display the part in error 
with an appropriate message. 

The following are sample invocation lines for VMS systems: 

COMHPC /B=(23,15)/M TEST 

COMHPC /H=THIS_SESSION [DEMO]SAMPLE 

COMHPC /E=THIS_SESSIONTEST 

The first command line sets the microcontroller development system SH blocks 2,8, and 15 for download 
and loads the file TEST.COF. Monitoring of the microcontroller development system is also enabled. 

The next command line opens file THIS_SESSIONHIS for recording this session. File SAMPLE.COF 
which resides in the directory DEMO is loaded. 

The last command loads file TEST.COF and then executes the history file THIS_SESSION.HIS. 
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C^.2 Options 

An invocation line option is specified in a manner consistent with the VMS operating system. Refer to 
Section 2.8 for a detailed description of the options. 

Options for the VMS operating system follow the rules of the DEC command line int^reter. Each option 
is preceded by a “/”. Options are not case sensitive. 

See Section C.2.4 for mapping between VMS and MS-DOS invocation line options. 

C.2.3 Default File Extensions 

For VMS operating systems, a default extension is always placed on a file unless one is explicitly 
specified. 

C,2.4 Help File Search Order 

When searching for help file COMHPCJiLP, directories are searched in the following order: 

1. current directory 

2. default directories 

a. directory specified by logical name COMHPCS, if it exists 

b. directory specified by logical name HPC$, if it exists 

c. directory specified by logical name SYSHPCS 

C.2.5 Option Table 

Table C-1 shows the mapping between VMS and MS-DOS invocation. 
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Table C-1. Mapping Between MS-DOS and VMS Invocation 


MS_DOS 

VMS 

/B=block list 

/B=(block list) 

/B=OFF 

/B=OFF 

/E=input file 

/E=input file 

/H=history file 

/H=history file 

/L=line 

/L=line 

/L=line,baud 

/L=(line,baud) 

/M 

/M 

/R 

/R 

/S=file 

/S=file 
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Appendix D 

SETTING UP FOR COMHPC 


D.l INTRODUCTION 

This ^pendix describes the step-by-step procedure for setting up and verifying the hardware required to 
operate COMHPC on an MS-DOS system. 

D.2 PROCEDURE FOR CONFIGURATION 
The procedure is divided into two parts: 

• Connecting the MS-DOS and the microcontroller development system with an RS232 cable. 

• Verifying the hardware connection. 

D.2.1 Hardware Setup 

The MS-DOS COMl port and the microcontrolla development system are ccmnected by an RS232 cable. 
Appendix A discusses the RS232 cable and the microcontrolla- development system port to use. 

D.2.2 Hardware Verification 

The hardware is tested by creating a HPC COFF file, loading the file from the MS-DOS system to the 
microcontrollCT development system and voifying that the file was received correctly. 

1. Create the following file test.asm using your text editor: 

•SECT TEST,ROM16,ABS=OFOOO 

LOOP: JP 

.FB 0800,0 ; data 

.END LOOP 

2. Assemble and link file using current revisicm software. 

C> ASMHPC testasm 
C> LNHPCtesLobj 

3. PowCT up (or reset) the microcontroller development system and invoke COMHPC 

C> COMHPC/R 

4. COMHPC initializes the microcontroller development system and responds with its prompt 

coinhpc> 

5. Enter bypass mode 

coinhpc> BYPASS 
M> 
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At this point, the MS-DOS console is acting as the microcontroller development system con¬ 
sole. This shows that connection between the microcontroller development system and MS- 
DOS system is correct, and the microcontroller development system prompt M> shows that 
the microcontroller development system was initialized properly. 

6. Press <ESC> to escape bypass mode 

M> <ESC> 
comhpc> 

7. Download the test file to the microcontroller development system. 

coinhpc> LOAD testcof 

MOLE SH Blocks = 12,13,14,15 

block sent: 13 
retry: 0 

TRANSMISSION COMPLETE 

8. The microcontroller development system SH blocks defined for emulation are shown. During 
download, the number of blocks sent to the microcontrollCT development system and a count 
of retries is displayed (Retries should be zero for a clean connection). Upon successful down¬ 
load, the message transmission complete is displayed. Otherwise, an appropriate 
error message is echoed on the system console. 

The check-out is done. 
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Appendix E 

A SAMPLE COMHPC SESSION 


This is a brief example of a download session with COMHPC on an MS-DOS host system ctmnected to a 
the microcontroller development system. This assumes a COFF object module samplexof with 
bankswitched code at address 40(X)/4FFF. In this session, the user first loads the object file and then enters 
bypass mode to v^fy the code. History is enabled to record the session. 

Create file setup.his. This command file is used to provide setup for bankswitch. 

[setup.his] 

BYPASS ;enter bypass mode 

RESET ;Reset before bankswitch 

S breakpoint microcontroller development system 

MODIFY BFUN.O ;disable port B alt^nate function 

MODIFY DIRB, 6300 ;define bit 8,9,13,14 of port B as output 

Create file swbankO.his. This command file will be used to switch to bank 0. 

[swbank0.his] 

@setup ;do setup for bankswitch 

MODIFY M E3,0 ;bank 0 user defined as upper byte of port B = 0 

Create file swbankl.his. This is used to switch to bank 1. 

[swbankLhis] 

©setup ;do setup for bankswitch 

MODIFY M E3,1 ;bank 1 user defined as upper byte of port B = 1 

Assume the ctmsole port of the microcontroller development system is connected to COM2 port of the 
MS-DOS system. The user sets SH blocks 14 and 15 to use for emulation; he is using SH memory as the 
non-bank switched memory at address EOOO/FFFF. The user has provided bankswitched user memory at 
address 40(X)/4FFF, for bank 0 and bank 1. The microcontrollCT development system is powwed up, and 
the following invocation line is entered. COMHPC loads the file sample.cof. 

OCOMHPC /B=14,15 /L=C0M2 /E=SwBankO /H=this_session sample 

MOLE SH blocks = 14,15 

block sent: #### 
retry: 0 

TRANSMISSION COMPLETE 

Next, COMHPC starts executing commands fiom file swbank0.his. 

comhpc>@ setup ;do setup for bank switch 

comhpoBYPASS ;enter bypass mode 

M>RESET ;Reset before bankswitch 

M>S ;Breakpoint microcontroller development system 

M>MODIFY BFUN, 0 ;disable port B alt^nate function 
M>MODIFY DIRB, 6300 ;define bit 8,9,13,14 of port B as output 

M>MODIFY M E3,0 ;bank 0 user defined as upper byte of port B = 0 
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User then enters command to check code at address 40(X)/4FFF. 


m>L 1ST 4000/4FFF ;show bank 0 at 4000/4FFF 


Next, the user returns to COMHPC by entering <ESC> and issues the command to execute file 
swbankLhis to switch to bank 1. Th e us e r then e nters commands - te - verify rode at address 4 000 ,— g _, 


M><ESC> 

comhpc>@swbankl 

comhpc>@ setup 
comhpoBYPASS 


;switch to bank ^ 

;COMHPC starts executing commands from file “swbankl.his” 
;do setup for bank switch 
'.enter bypass mode 


M>RESET 

M>S 

M>MODIFYBFUN,0 
M>MODIFY DIRB, 6300 


;Reset before bankswitch 
breakpoint microcontroller development system 
;disable port B alternate function 
;define bit 8,9,13,14 of port B as output 


M>MODIFYME3,1 ;bank 1 user defined as port B address = 0 


User then enters command to check code at address 4000/4FFF. 


M>LIST 4000/4FFF '.show bank 1 at 4000/4FFF 


Now the user returns to COMHPC to exit the session. 

M><ESC> 
coinhpc> END 

For more information on bankswitch linkCT, see HPC Assembler/Unker/Librarian User’s Manual. 
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Overall Quality 

□ 

□ 

□ 

□ 

□ 

NAME 




DATE 



TITLE_ 

COMPANY NAME/DEPARTMENT_ 

ADDRESS_ 

CITY_STATE_^ZIP 

Do you require a response? □ Yes □ No PHONE_ 

Comments: 


Communications Program (COMHPC) 


cm. FOLD, STAPLE, AND MAIL 


424420188-001A 




